Skip to content

feat(animate): [#205] N-keyframe tracks общим owner/lifecycle — DRAFT: ждёт size-решения - #284

Draft
lemone112 wants to merge 1 commit into
mainfrom
feat/animate-keyframe-tracks-205
Draft

feat(animate): [#205] N-keyframe tracks общим owner/lifecycle — DRAFT: ждёт size-решения#284
lemone112 wants to merge 1 commit into
mainfrom
feat/animate-keyframe-tracks-205

Conversation

@lemone112

Copy link
Copy Markdown
Contributor

Что

Драфт 1302129 (июль) пересобран на свежий main: tuple tracks x:[0,120,-40,0] + times/ease[] с общим owner/lifecycle; конфликт кодов ошибок разрешён переномерацией LM168/LM169 → LM173/LM174 (каталог дошёл до LM172 после #223/#281).

Гейты локально

  • Тесты: 3999 passed (включая 420-строчный корпус animate-keyframes-tracks: C¹ на стыках, матрица некорректных times, топология). Typecheck PASS, audit clean.
  • Size: RED — честная цена фичи +778 B gz (mixed 18278 > 17500, фасад 16328 > 15600). Исторический драфт сам поднимал пороги (12760→…); по INV-17 плана и политике 2026-08-15 пороги поднимает только Даниил.

Блокер (красный гейт)

Это не регрессия, а стоимость новой способности — N-keyframe треки не выразимы в текущем бюджете. Вопрос Даниилу уже поднимался в августе (люфт тогда был 48 B, сейчас после волны фичей — 778 B). Варианты:

  1. Поднять пороги от факта (18278+люфт / 16328+люфт) — цена фичи задокументирована;
  2. Гольф-спринт до внесения — часть цены снимаема, но класс ~500+ B останется (новый track-механизм);
  3. Отложить feat(animate): объединить N-keyframe tracks общим owner/lifecycle #205 до компилятора feat(compiler): статические N-keyframes → compact MotionProgram после #205 #222 (статические keyframes уходят в build-time, runtime-цена падает).

Рекомендация: вариант 1 — фича из milestone-структуры #106 (0.4 core), цена измерена и объяснена, дальше её съедает компилятор #222.

Контекст плана

Узел KEYF-01 трека lab-motion-production → in progress, blocked на решение по порогу.

Базовая keyframe-грамматика поля (Framer/GSAP/anime — everyday-форма по
калибровке) в полном ./animate одним lifecycle с прежними контролами:

  animate('.dot', { x: [0, 120, -40, 0], opacity: [0, 1, 1, 0] }, {
    duration: 800,
    times: [0, 0.25, 0.75, 1],
    ease: [easeOut, linear, easeIn],
  })

Контракт (#205):
  - AnimatePropValue: destination | пара [from, to] | кортеж ≥3 (все стопы
    явные; snapshot до валидации — hostile getters читаются ровно один раз);
  - options.times: конечные, неубывающие, 0→1; дубликаты легальны —
    right-biased скачок нулевой ширины; без times offsets равномерные;
  - options.ease: scalar (применяется К КАЖДОМУ сегменту — для 2-стопового
    трека совпадает с глобальным) либо массив длины N−1;
  - при times/ease[] все каналы вызова несут одну authored-топологию N
    (скрытых эвристик нет) — иначе LM168/LM169 (новые коды каталога);
  - трек + явная spring — синхронный LM136; трек без опций получает
    tween-режим по умолчанию (keyframe-грамматика — keyframe-движку);
  - reduced-motion публикует последний стоп без rAF/WAAPI-резервации;
  - residual-transform сохраняется; C¹-подхват при перехвате трека:
    числовые каналы наследуют value+velocity (производная в пространстве
    значения тем же шагом, что tween-дериватив); CSS-треки — C⁰ (та же
    лестница деградации, что var()/смешанные AST).

Архитектура: один pure-модуль animate/track.ts (right-biased просмотр с
переиспользуемым out-scratch — ноль аллокаций в кадре) владеет всей
топологией; числовой и CSS-пути делят ОДИН просмотр; кодеки значений не
копируются (interpolateParsed/buildTransform как были). 2-стоповые пути
бит-в-бит не тронуты (глобальный ease, прежние формулы производной).

Приёмка: 21 тест — differential N=3/4/11 против независимого наивного
семплера (равномерные/authored/дублированные offsets, числовой и цветовой
кодек), zero-width right-bias, multi-target+stagger+onComplete один раз,
seek/pause/cancel/reduced, pickup-vs-rest доказательство C¹, residual
transform, hostile sparse/getter-массивы, матрицы LM168/LM169/LM136/LM138/
LM141. Полный сьют 3870, Chromium-conformance 48/48.

Размер: потолки фасада переставлены ОТ ФАКТА решением владельца (хронология
в scripts/size-gate.mjs): one-liner 12000 → 12760 (факт 12694; ~0.7 KB gz —
цена everyday-грамматики, дешёвые шейвы сняты до подъёма, дедупа в графе
фасада не существует), animate+compositor 12494 → 13340 (факт 13275),
новый consumer-ратчет 'animate-keyframes (N-track)' 12725/12760. nano
байт-в-байт 1011 B gz.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Nxb7WrgKwSSTEJYiEz2zYf
@coderabbitai

coderabbitai Bot commented Aug 18, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 80ea829a-a353-4522-8a87-5b98c2e14b0d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants